home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / antenna / azproj10 / readme.azp < prev    next >
Text File  |  1995-07-19  |  15KB  |  408 lines
  1.     This file is README.AZP for AZ_PROJ.PS v1.00, Jun 1995.
  2. AZ_PROJ.PS (C) 1994, 1995 Joseph Mack NA3T and Michael Katzmann NV3Z
  3.  
  4.     AZ_PROJ is a set of files that generates azimuthal equidistant
  5. projections of the earth from (almost, see bugs) any location, giving
  6. bearing and distance from your location to any other place on the
  7. surface of the earth.
  8.  
  9.     AZ_PROJ uses Level 1 Postscript, unless you are using
  10. a color PostScript printer (which we assume are all Level 2), in which
  11. case some Level 2 instructions are used.
  12.  
  13.     The files output on a Postscript device (printer, display
  14. or through Postscript interpreters like Ghostscript - see file
  15. ghost.doc for setup suggestions) and hence are computer
  16. independent. Ghostscript runs on many computers (MSDOS, unix)
  17. producing output in X-windows (unix or DesqviewX), or under MSDOS
  18. with a 386 chip to a VGA display. Ghostscript produces native code for
  19. many printers, allowing many printers to function as a postscript printer.
  20. The data to produce the coastlines, countries, states, rivers, lakes,
  21. and islands comes from the public domain CIA World Data Bank.
  22.  
  23.     AZ_PROJ is distributed under the GNU License (see the file
  24. COPYING).
  25.  
  26. The zip file AZ_PROJ.ZIP contains the following files.
  27. text files:
  28. COPYING        The GNU License under which this set of files is distributed
  29. GHOST.DOC    Hints for setting up ghostscript
  30. SIMPSON.DOC    Article about NMEA by Wayne Simpson
  31. README.AZP    This file
  32.  
  33. dat files:
  34. ANNOT.DAT    An example annotation file
  35. BEA_6M.DAT    The 6m beacon list, from M. Harrison in G land
  36. BEA_W3EP.DAT    The beacon list, maintained by W3EP
  37. DXCC.DAT    The ARRL dxcc countries list, maintained by K2DI
  38. GRID.DAT    An example file for grid squares that have been worked
  39. MOUNTAIN.DAT    An example file for plotting mountain tops
  40. NMEA.DAT    An example NMEA format file for GPS location of QTH
  41. REPEATER.DAT    An example file for plotting repeaters
  42. ROVER.DAT    An example file for plotting rovers
  43.  
  44.  
  45. Postscript files:
  46. AZ_INI.PS    The initialisation file - edit for your location and needs
  47. AZ_PROJ.PS    The Postsript file which has the routines and generates the
  48.                    projection
  49. CONTROLD.PS    The ^D symbol (EOF for a postscript printer).
  50.  
  51. wdb files:
  52. AFRICA.WDB    Positions of points on the surface of the earth
  53. ANTARCT.WDB         derived from the CIA World Data Base
  54. EURASIA.WDB        ""
  55. N_AMER.WDB        ""
  56. OCEANIA.WDB        ""
  57. S_AMER.WDB        ""
  58.  
  59. some of the example bat files for MSDOS:
  60. AZVIEW.BAT    view a continent under Ghostscript
  61. AZ_VIEW.BAT    other sample files for viewing maps
  62. AZFILE.BAT    generate a file for later printing
  63. AZGRID.BAT    generates picture with grid squares but no map
  64. AZPRINT.BAT    print under Ghostscript directly to a printer
  65. AZ_PRINT.BAT    other sample files for printing maps
  66. MAKDAT.BAT    concatenate .dat files
  67. MAKWORLD.BAT    make the concatenated file world.wdb
  68. MAK_NA.BAT    file for generating North America on a postscript printer
  69.  
  70.  
  71.     This file (README.AZP) is a brief description of the use of
  72. AZ_PROJ.PS. For a detailed explanation see the comments in each file.
  73.  
  74. AZ_INI.PS
  75.  
  76.     AZ_INI.PS has variables which allow the map to be customised.
  77. The variables are ordered according to the way we wrote the program.
  78. In general the order of variables can be changed to suit your needs,
  79. as long as variables which are defined in terms of other variables
  80. are not exchanged in order (eg colors need to be defined before you
  81. use them). AZ_INI.PS is full of comments which will tell you how to
  82. customise AZ_PROJ. You can remove these comments when no longer
  83. needed.
  84.  
  85.  
  86.     Customisation:
  87.  
  88.     AZ_PROJ will arrive set up to give reasonable test maps without
  89. any changes (the following values in "options"). The QTH will be set to
  90. ARRL HQ as your QTH, the QTH will be at the center of the map
  91. (ie not center offset), grid locator lines and labels will be
  92. turned on, orientation will be portrait, and the scale (200km/cm)
  93. will give a view of most of North America.
  94.  
  95.     The main place for customisation is the "options" array.
  96.  
  97. /options
  98. [
  99. 41.6    -72.7    (ARRL HQ)    % lat, lon, string, for QTH
  100. 45.0    -90.0    off        % lat, lon (middle of NA), center_offset (here off, using QTH as center)
  101. 200     on            % scale, using km/cm (off = degrees),
  102. off                % landscape (off = portrait)
  103. on    on            % letter grid squares, labels
  104. on    on            % number grid squares, labels
  105. on    on            % compass circumference, compass radial spokes
  106. on                % outerborder
  107. on                % DXCC countries by callsign (off = by country name)
  108. ] def
  109.  
  110.  
  111. .WDB files
  112.  
  113.     These are an ascii version of the Central Intellegence Agency
  114. Micro World Data Base (CIA WDB) adapted for AZ_PROJ. These files contain
  115. geographic information.
  116.  
  117.  
  118. .DAT files:
  119.  
  120.     These are files containing one piece of information per line.
  121. Each line starts with a word (eg beacon) followed by a ":" (beacon:).
  122. These .dat files contain ham specific information such as dxcc
  123. lists of countries worked and not worked, grid squares worked,
  124. beacons, and any annotations that you want to put on the map
  125. ("Mom's place"). Enough information has been included at the
  126. start of each file for you to be able to add/change entries.
  127.  
  128.     Since the .dat files are just collections of lines, there is
  129. no real reason to keep the .dat files separate - in principle
  130. the .dat files can be concatenated and the lines put in any order.
  131. We have kept them separate mainly for bookkeeping purposes.
  132.  
  133.     Comments are added by adding the char "%" at the beginning of a line.
  134.  
  135.     Annotations (annot.dat) can be used to mark any spot on the map.
  136.  
  137.     Note: Order of files.
  138.  
  139.     Files can be sent in any order. However the output of each
  140. file will cover up the output of all previous files. Thus the order
  141. in which .dat files are sent to the output (the order in the command line
  142. or in the combined file sent to a printer) affects the look of the map.
  143. The NMEA.dat file uses Global Positioning System (GPS) NMEA formatted data
  144. to locate the QTH (such as on a mountain top). This _must_be read first
  145. as it will move the QTH from that established in az_ini.ps. The output
  146. from grid.dat is an area of solid color that will cover anything
  147. under it (including the waypoint info from the nmea.dat file,) thus
  148. it should go next. The other .wdb/.dat files put points of interest
  149. on the map and these should go later than the grid.dat data.
  150.  
  151.     An example command line to put the files in the correct order
  152. would be
  153.  
  154. C:>gs -q az_ini.ps -- az_proj.ps nmea.dat grid.dat n_amer.wdb *.dat
  155.  
  156.     When sending to a real Postscript printer, these files could be
  157. concatenated, again in the correct order, by generating the file nacomb.ps,
  158. and then sending nacomb.ps to the printer.
  159.  
  160. C:>copy az_ini.ps+az_proj.ps+grid.dat+n_amer.wdb+mountain.dat+beacon.dat nacomb.ps
  161.  
  162.  
  163.  
  164. SENDING TO OUTPUT
  165.  
  166. Sending to a Postscript Printer:
  167.  
  168.     The simplest (but because of expense, probably least accessible
  169. to hams) route to using AZ_PROJ.PS is to send it and the data
  170. files to a Postscript printer. The files must be sent as one stream
  171. (ie one big concatenated file) in the suggested order
  172.  
  173. az_ini.ps
  174. az_proj.ps
  175. nmea.dat
  176. grid.dat
  177. *.wdb files
  178. *.dat files
  179. contrld.ps
  180.  
  181.     At the end of the concatenated file, there MUST be an EOF
  182. (usually ctrl D) for the printer to know that it had come to the
  183. end of the job. This is usually sent by the spooler, but if your
  184. setup (like most MSDOS setups) doesn't do this, you'll wait hours
  185. till the printer times out. If this is your situation, concatenate
  186. contrld.ps onto the end of your file for printing.
  187.  
  188.     AZ_INI.PS should arrive set for ARRL HQ in Connecticut USA,
  189. with a scale (250km/cm) that will give a map showing most of North
  190. America. The map will be centered on 45N, -90W, however the azimuthal
  191. projection will be centered on ARRL HQ (bearings and distance will
  192. be correct for ARRL HQ).
  193.  
  194.     The variables "send_notices" and "verbose" will be set to
  195. "on" for sending to a screen (if using ghostscript to display on
  196. a screen). These notices will give you an indication of progress,
  197. as due to buffering etc by ghostscript and the slowness of execution,
  198. there are times when not much is happening on the screen. For printing
  199. set these variables to "off" or you will get pages of notices after
  200. the real output comes out.
  201.  
  202.  
  203. EXAMPLES:
  204.  
  205. Printing -
  206. (make sure to turn "off" send_notices and verbose in the az_ini.ps file)
  207.  
  208. - to a postscript printer (DOS)-
  209.  
  210.     Run mak_na.bat
  211.  
  212.     C:\gs>mak_na
  213.  
  214.     This will produce na_comb.ps (about 1.4Mb). Send this new file
  215. to your postscript printer with
  216.  
  217.     C:\gs>print na_comb.ps
  218.  
  219. - to a postscript printer (UNIX)-
  220.  
  221.     $ cat az_ini.ps az_proj.ps n_amer.wdb |lp
  222.  
  223. - to a screen/printer via an Interpreter:
  224.  
  225.     An interpreter (such as Ghostscript) runs on a computer and
  226. knows about files. The names of the data files are then given
  227. as parameters to the interpreter. You can send multiple .WDB and .DAT
  228. files to ghostscript as command line parameters. Note that az_proj looks
  229. to see the size of the display it is printing (or screening) on. Since
  230. the screen and printer are different sizes, you will not neccesarily
  231. get the same picture when previewed on a screen as you will on the
  232. printer.
  233.  
  234. - screen viewing for DOS:
  235.  
  236.     C:\gs>gs386 -q az_ini.ps -- az_proj.ps n_amer.wdb
  237.  
  238.     or run the supplied file azview.bat
  239.  
  240.     C:\gs>azview
  241.  
  242. - to a file for later printing
  243.  
  244.     To make the file `n_amer.cdj' which can then be sent to
  245. a color desk jet 550 (which ghostscript calls a "cdj550", see the
  246. ghostscript docs for details of other printers) -
  247.  
  248.     C:\gs>gs386 -q -sDEVICE=cdj550 -sOutputFile=n_amer.cdj az_ini.ps -- az_proj.ps n_amer.wdb dxcc.dat
  249.  
  250.     or run the supplied azfile.bat file
  251.  
  252.     C:\gs>azfile
  253.  
  254.     The format of this command is
  255.  
  256.     DOS command             (gs)
  257.     gs switches        (-q -sDEVICE=cdj550 -sOutputFile=n_amer.cdj)
  258.     postscriptfilename      (az_ini.ps)
  259.     another switch            (--)
  260.     datafiles for az_ini.ps (az_proj.ps n_amer.wdb dxcc.dat)
  261.  
  262. - sending a file to a printer
  263.  
  264.     You can send output to the printer directly (see below). However
  265. you might want to generate the file if you want to print several copies of
  266. the map (and only have to calculate the map once), or you have a spooler
  267. (recommend dmp205.zip, look on a BBS) which will give you back your
  268. keyboard again, so you can go on with something else during the printing.
  269.  
  270.  
  271. - without a spooler
  272.  
  273.     C:\gs>copy/b n_amer.cdj lpt1:
  274.  
  275. - to the printer directly
  276.  
  277.     To send to the printer (through lpt1:, note: can use MODE to redirect)
  278.  
  279.     C:\gs>gs386 -q -sDEVICE=cdj550 az_ini.ps -- az_proj.ps n_amer.wdb dxcc.dat
  280.  
  281.     or run the supplied azprint.bat file
  282.  
  283.     C:\gs>azprint
  284.  
  285. - using ghostscript to simulate a printer
  286.  
  287.     Sending to a printer is slooow and some printers (DEC for instance)
  288. don't seem to like our code. If you aren't getting output from your
  289. printer after a reasonable time, then try making a smaller comb.ps file
  290. (no .wdb files, turn off all lines and try just printing the Title info).
  291. If that doesn't work, you can use ghostscript to simulate a printer to
  292. see what's wrong. Try
  293.  
  294.     c:\gs>type comb.ps | gs386 -q -
  295.  
  296.     The first part of the instruction sends the file to stdout, the
  297. second part tells gs386 to take input from stdin (for unix change "type"
  298. to "cat"). You'll get a screen display instead of printout. Note that 
  299. comb.ps will have the EOF for the operating system and controld.ps
  300. is not needed (but will do no harm) in comb.ps.
  301.  
  302. for UNIX:
  303.  
  304. To printer (without creating an intermediate file)
  305.  
  306.     %gs -q -sDEVICE=cdj550 '-sOutputFile=|lp -or -onb' \
  307.         -r300 -dNOPAUSE az_ini.ps -- az_proj.ps n_amer.wdb dxcc.dat
  308.  
  309.  
  310. COLOR PRINTERS:
  311.  
  312.     If you have a color printer, read the poop in az_proj.ps
  313. about gamma correction (search for string "gamma"). If you have
  314. a Deskjet550C or 1200C you are already covered. If you don't
  315. get this right, then the colors you get on the screen will not
  316. be the same as on the printer.
  317.  
  318.  
  319. CUSTOMISING AZ_PROJ
  320.  
  321. "send_notices" and "verbose"
  322.  
  323.     You can have these "on" if you have a launching window
  324. (ie a window which is different to the window displaying the map)
  325. to display these messages.
  326.  
  327.     You HAVE a lauching window in multitasking systems like
  328. Windows, DesqViewX, X-window, and a Mac using LaserWriterUtilities
  329. ("send PostScript document to printer") and a Postscript printer,
  330. which gives you a .log file to dump the error output.
  331.  
  332.     You DO NOT have a lauching window in MSDOS (the error
  333. messages will write all over your screen output) or on a postscript
  334. printer (where the messages will come out on subsequent pages, except
  335. on a Mac where they go to a file). For these latter systems use "off".
  336.  
  337.     Next change the lat/lon to your QTH (use decimal degrees,
  338. eg 90.05, with N and E being positive, S and W being negative),
  339. center_offset (2nd line) to "off", change the scale to "500"
  340. and scale type to "off". There being two authors on this project
  341. there are two ways of doing this. The first is the original method,
  342. which is just to change the value of say lon_QTH (just below the
  343. heading "Manual method" in az_ini.ps. This method works for all
  344. variables in az_proj.ps. We think that only a few of these variables
  345. are going to be changed a lot and they have been put in an array
  346. called /options in az_ini.ps. To activate the /options option, turn
  347. the variable /use_automatic_option "on". The values in the array
  348. /option will then override the values declared elsewhere in
  349. az_ini.ps.
  350.  
  351.  
  352.     You can turn letter_squares and labels on/off, with
  353. number_squares and labels on/off.
  354.  
  355.     Run gs386 sending output to the screen. Intitially just let
  356. az_proj.ps generate grid squares by not feeding any map data to it -
  357.  
  358.     C:\gs\azgrid.bat
  359.  
  360.     After the grid squares are output, the program will ask
  361. for input. You can either manually type in points on the earth
  362. (in .wdb format), which is tedious, or exit.
  363.  
  364.     Next feed it some data file(s), e.g. dxcc.dat and various
  365. continent(s) (africa.wdb, antarct.wdb, eurasia.wdb, n_amer.wdb,
  366. oceania.wdb, s_amer.wdb).
  367.  
  368.     C:\gs>azview.bat
  369.  
  370.     or for a few more continents
  371.  
  372.     C:\gs>gs386 -q az_ini.ps -- az_proj.ps n_amer.wdb s_amer.wdb dxcc.dat
  373.  
  374.     GS386 gives output for about double the area that will be
  375. printed, so you will have to learn to correct for this. As well the colors
  376. on the screen are rather washed out and not a good representation of the
  377. final colors printed (the colors for the version that runs under DesqViewX
  378. are very good and the area presented to the screen is the same as for
  379. the printer).
  380.  
  381.     If this goes well, create an output file for a printer
  382.  
  383.     C:\gs>azprint.bat
  384.  
  385.     or
  386.  
  387.     C:\gs>gs386 -q -sDEVICE=cdj550 -sOutputFile=your_qth.cdj az_ini.ps -- az_proj.ps n_amer.wdb s_amer.wdb bea_w3ep.dat
  388.  
  389.     A command line like this may be too long for brain damaged MSDOS,
  390. so you have to concatenate some of the files. If you do the following
  391. concatenations (perhaps as bat files)
  392.  
  393.     C:\gs>copy n_amer.wdb+s_amer.wdb amer.wdb
  394.     C:\gs>copy dxcc.dat+bea_w3ep.dat na.dat
  395.  
  396.     then the previous instruction becomes
  397.  
  398.     C:\gs>gs386 -q -sDEVICE=cdj550 -sOutputFile=your_qth.cdj az_ini.ps -- az_proj.ps grid.dat amer.wdb na.dat
  399.  
  400.     For world maps, the file "world.wdb" can be created from the
  401. supplied "*.wdb" files by running the supplied file "makworld.bat".
  402.  
  403.     Have fun
  404.     Our addresses are in AZ_PROJ.PS
  405.  
  406.     Mike NV3Z and Joe NA3T
  407.     Jun 1995
  408.